home *** CD-ROM | disk | FTP | other *** search
/ GFX Sensations 1 / Graphic Sensations - Volume 1.iso / tools / amiga / gfx_card / viewpnm.lha / viewpnm / ViewPNM.doc < prev    next >
Encoding:
Text File  |  1994-05-07  |  5.4 KB  |  147 lines
  1.  
  2.          ViewPNM 1.32
  3.          ============
  4.  
  5.  
  6. What is ViewPNM?
  7. ~~~~~~~~~~~~~~~~
  8.  
  9. ViewPNM is an image viewer for PICASSO II gfxboards. It  displays  PPM
  10. (24  Bit),  PGM  (8  Bit  Grey)  and PBM (1 Bit) files produced by the
  11. picture converter/manipulator tools from the PBM, PBMPLUS  and  NETPBM
  12. libraries (Available on Aminet or sundry CD-Roms).
  13.  
  14.  
  15. Disclaimer
  16. ~~~~~~~~~~
  17. The  author  cannot  be held liable for the suitability or accuracy of
  18. this manual and/or the program(s) it describes. Any damage directly or
  19. indirectly  caused  by  the  use  or  misuse of this manual and/or the
  20. program  it  describes  is the sole responsibility of the user her/him
  21. self.
  22.  
  23.  
  24. Copyright/Distribution
  25. ~~~~~~~~~~~~~~~~~~~~~~
  26. ViewPNM, © Copyright 1994 Reinhard Haslbeck. All rights reserved. This
  27. program  may  be  freely  distributed as long as all documentation and
  28. executable(s) remain unchanged and are included with the distribution.
  29. Also  no  profit  is  to  be made by selling this program. You may not
  30. charge more than Fred Fish does for a single library disk.  Commercial
  31. distribution  is  NOT  allowed  without  written  permission  from the
  32. author. It is allowed for non-commercial BBSs to distribute an archive
  33. with only the following files in it to save your users some money when
  34. they want to download this program. NOTE: All files listed below  MUST
  35. be  distributed  together.  None  of  the  files  listed  below may be
  36. distributed on it's own!  They  may  ofcourse  be  archived  with  any
  37. archiver.
  38.  
  39.          ViewPNM                  - Main Program
  40.          ViewPNM.info             - Icon
  41.          ViewPNM.doc              - Manual
  42.          ViewPNM.doc.info         - Icon
  43.          IntuiView.prefs.add      - add this to 'IntuiView.prefs'
  44.          IntuiView.prefs.add.info - Icon
  45.          PBMGUI.config.add        - add this to 'PBMGUI.config'
  46.          PBMGUI.config.info       - Icon
  47.  
  48.  
  49. How to use
  50. ~~~~~~~~~~
  51. ViewPNM can be started from Workbench or Shell. If You start it from a
  52. Shell the below listed arguments are allowed. Type 'ViewPNM ?' and all
  53. available arguments are shown:
  54.  
  55.  
  56.       FILENAME/M,W=WAIT/K/N,M=MODEID/K/N,V=VERBOSE/S:
  57.  
  58.  
  59. FILENAME:
  60.       Simply the name of the picture you want to see. If  no  Filename
  61.       is   entered,   a   Filerequester  will  appear.  AmigaDos-style
  62.       pattern-matching is also supported.
  63.  
  64. WAIT:
  65.       This is the optional duration time a picture will be  displayed.
  66.       Useful for slideshows.
  67.  
  68. MODEID:
  69.       If You don't want the ScreenModeRequester to appear, You have to
  70.       set  a vailid ScreenModeID for an Picasso 8/15/16/24 Bit Screen.
  71.       The ID has to be for an 15-,16- or 24Bit Screen if the image  is
  72.       a  PPM  or  a PGM file and for an 8 Bit Screen if the image is a
  73.       PBM file. Look out for the utility 'VScreenID'  which  helps  by
  74.       getting  the  IDs  If  You  choose an ID which nominal sizes are
  75.       smaller than the picture, the Screen will  be  an  AutoScrolling
  76.       one  if  possible.  If  the  pictures  dimensions are too big to
  77.       display, it will be cropped.  If  the  pictures  dimensions  are
  78.       smaller than the Screen, it will be displayed centered.
  79.  
  80. VERBOSE:
  81.       By default  no  messages  are  printed  out,   even
  82.       errormessages  are  disabled.  If  You set VERBOSE, You will get
  83.       some information about the image, Screen etc.
  84.  
  85. If ViewPNM is started from  Workbench,  You  can  set  values  to  the
  86. Tooltypes  'WAIT', 'MODEID' and 'VERBOSE', which have the same meaning
  87. as they have in Shellstart.
  88.  
  89. Pressing a key or a mousebutton will  close  the  Screen  and  ViewPNM
  90. fetches  the  next  File  (in  Pattern  Matching  mode) or pops up the
  91. Filerequester again. Press the <ESC> key or  select  'Cancel'  in  the
  92. File/ScreenRequest to abort the program.
  93.  
  94.  
  95. Requirements
  96. ~~~~~~~~~~~~
  97.    - An Amiga Computer with a UNSEGMENTED driven PICASSO II pluged in
  98.    - 'vilintuisup.library' V2.x+
  99.    - Amiga OS2.04+
  100.  
  101. Notes
  102. ~~~~~
  103.    - ViewPNM has not been tested on 1BM PICASSOs
  104.  
  105. History
  106. ~~~~~~~
  107.      V1.0 -> V1.1:  Now Handles PGM-files.
  108.      V1.1 -> V1.2:  Now Handles PBM-files, added MODEID-Option.
  109.      V1.2 -> V1.21: fixed Bug by handling very large pics,
  110.                     program now exits if ScreenModeRequest is canceled.
  111.      V1.21 -> V1.3: Speed improvement by reading the file in blocks of
  112.                     8 imagelines.
  113.                     Added 8Bit displays for 24Bit images using a fixed
  114.                     palette.
  115.                     Doesn't force Screen dimensions to 4:3 aspect any-
  116.                     more.
  117.                     <ESC>-Key now quits program.
  118.                     Support for Workbench ToolTypes.
  119.                     Sundry internal changes/enhancements.
  120.      V1.3 -> V1.31: exit on <CTRL>+<C> is disabled.
  121.      V1.31-> V1.32: Thanks to Gerhard Muellers 'gerlib', ixemul.library
  122.                     isn't needed anymore.
  123.                     Opens info window when started by icon if tooltype
  124.                     'VERBOSE' is set.
  125.                     Compiled without '-funroll-loops' for shorter code.
  126.  
  127. Thanks to
  128. ~~~~~~~~~
  129.     Markus M. Wild for the GCC port
  130.     Christian Stieber for some GCC hints
  131.     Ingo Wilken for the NetPBM project
  132.     Village Tronic
  133.     Gerhard Mueller for 'Gerlib'
  134.  
  135. author
  136. ~~~~~~
  137. Address:    Reinhard Haslbeck
  138.             Spirknerstr. 7
  139.             84137 Vilsbiburg
  140.             GERMANY
  141.  
  142. Phone:      +49/(0)8741 8676 , +49/(0)8741 91212
  143. Fax:        +49/(0)8741 7140
  144.  
  145. Internet:   haslbeck@informatik.tu-muenchen.de
  146.  
  147.